home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / document / hypertxt / udo3017 / doku / udosh.u < prev   
Encoding:
Text File  |  1995-11-25  |  12.7 KB  |  363 lines
  1. ############################################################
  2. # Die Anleitung zur GEM-Version
  3. # von Dirk Hagedorn, 12.04.1995
  4. ############################################################
  5. !include add\header.ui
  6.  
  7. !title Die Anleitung zur GEM-Version von
  8.  
  9. !hyphen Ein!-stel!-lun!-gen
  10. !hyphen Ziel!-datei
  11.  
  12.  
  13. !begin_document
  14.  
  15. !stg_short_toc
  16. !pch_short_toc
  17.  
  18. !maketitle
  19. !tableofcontents
  20.  
  21.  
  22. ############################################################
  23. # Einführung
  24. ############################################################
  25. !node Einführung
  26.  
  27. !stg_subtoc
  28. !pch_subtoc
  29.  
  30. #-----------------------------------------------------------
  31. # Vorwort
  32. #-----------------------------------------------------------
  33. !subnode Vorwort
  34.  
  35. Ab Release 3 wird UDO nun zusätzlich mit einer komfortablen GEM-Shell
  36. ausgeliefert, die den meisten Benutzern eher entgegenkommen dürfte als 
  37. die Kommandozeilenversion. In dieser Shell steckt einiges an Arbeit, Zeit 
  38. und Nerven. Ich hoffe, sie ist intuitiv zu bedienen und einigermaßen 
  39. zweckmäßig.
  40.  
  41. Die GEM-Shell läuft ab 640 x 400 Punkten mit beliebiger Farbtiefe 
  42. unter TOS, Mag!X und MultiTOS und läßt sich sowohl als Applikation als 
  43. auch als Accessory verwenden. Die Shell läßt sich auch in 
  44. nie!-dri!-ge!-ren Auflösungen starten und verweigert dort ihren Dienst 
  45. nicht. Ob und wie man dann mit ihr arbeiten kann, habe ich nicht 
  46. getestet.
  47.  
  48. Die Shell ist weitestgehend selbsterklärend. Wie sie funktioniert, hat man 
  49. spätestens nach 5 Minuten herausbekommen. Mir liegt es fern, an dieser 
  50. Stelle die Bedienung von Menüzeilen oder Fensterdialogen zu erklären, was 
  51. diese Doku nur unnötig aufblähen würde. Daher befinden sich in dieser 
  52. Anleitung nur die wichtigen Dinge be!-züg!-lich der GEM-Shell.
  53.  
  54.  
  55.  
  56. #-----------------------------------------------------------
  57. # Installation
  58. #-----------------------------------------------------------
  59. !subnode Installation
  60.  
  61. Die Installation gestaltet sich ungemein kompliziert: Man kopiere die Shell 
  62. irgendwohin, wo Platz ist. (!grin)
  63.  
  64. Dann melde man die Shell als Anwendung von Dateien vom Typ (!V)*.U(!v) an 
  65. und stellt (falls möglich) beim benutzten Desktop ein, daß die Shell 
  66. (!V)VA_START(!v) versteht. Fertig!
  67.  
  68.  
  69.  
  70.  
  71. #-----------------------------------------------------------
  72. # Unterstützte Protokolle
  73. #-----------------------------------------------------------
  74. !subnode Unterstützte Protokolle
  75.  
  76. Die Shell versteht Drag !& Drop. Falls man im NewDesk unter MultiTOS bzw. in 
  77. Gemini unter Mag!X eine Datei auf den Hauptdialog zieht, so wird diese 
  78. Datei im Hauptdialog als Quelldatei eingetragen bzw. als Zieldatei, wenn 
  79. man beim ""Draggen"" die Alternate-Taste gedrückt hält.
  80.  
  81. Desweiteren unterstützt UDO --- wie es sich heutzutage nunmal gehört --- 
  82. (!V)VA_START(!v). Erhält UDO eine (!V)VA_START(!v)-Meldung, so wird die 
  83. übergebene Datei als Quelldatei eingesetzt. Ist beim Eintreffen dieser 
  84. Meldung die Alternate-Taste gedrückt, so wird die übergebene Datei als 
  85. Zieldatei eingesetzt. Wird keine Datei per (!V)VA_START(!v) übergeben, so 
  86. wird lediglich der Hauptialog getoppt bzw. geöffnet.
  87.  
  88.  
  89.  
  90. #-----------------------------------------------------------
  91. # Einschränkungen
  92. #-----------------------------------------------------------
  93. !subnode Einschränkungen
  94.  
  95. !label Shareware
  96.  
  97. UDO ist Shareware! Aufgrund schlechter Erfahrungen in der 
  98. Ver!-gan!-gen!-heit, die ich mit der Resonanz auf andere Projekte gemacht 
  99. habe, ist diese Shell folgendermaßen eingeschränkt:
  100.  
  101. !begin_enumerate
  102. !item    Zu Beginn des Programms erscheint der Dialog ''Registrierung''.
  103. !item    UDO packt irgendwo einen Hinweis in die Zieldatei, daß man 
  104.         letz!-tere mit einer unregistrierten Version erstellt hat.
  105. !item    Am Ende des Programms muß man ein paar Sekunden warten.
  106. !end_enumerate
  107.  
  108. Die Shell ist ansonsten voll funktionstüchtig!
  109.  
  110.  
  111.  
  112.  
  113. ############################################################
  114. # Der Hauptdialog
  115. ############################################################
  116. !node Der Hauptdialog
  117.  
  118. !stg_subtoc
  119. !pch_subtoc
  120.  
  121. Der Hauptdialog ist aufgeteilt in eine Menüzeile, den Buttons zur Auswahl 
  122. der Quell- und Zieldatei sowie den Buttons zur Auswahl des Zielformates.
  123.  
  124. !image img\d_main.img UDO's Hauptdialog
  125.  
  126. Nachdem man den Button der Quell- oder Zieldatei anklickt, öffnet sich der 
  127. Fileselektor, in dem man die gewünschte Datei auswählt. Wählt man die 
  128. Quelldatei, so wird die Zieldatei gemäß den Einstellungen angepaßt (oder 
  129. auch nicht, wenn man es eben so will).
  130.  
  131. Das Zielformat bestimmt man durch einfaches Anklicken.
  132.  
  133. Ein Klick auf ''Konvertieren'' startet den Umwandlungsvorgang. ''Ende'' 
  134. beendet die Shell, ''Hilfe'' ruft den Hypertext zu UDO (nicht den zur Shell) 
  135. auf, sofern der ST-Guide installiert ist.
  136.  
  137.  
  138. #-----------------------------------------------------------
  139. # Die Menüzeile
  140. #-----------------------------------------------------------
  141. !subnode Die Menüzeile
  142.  
  143. !stg_subsubtoc
  144. !pch_subsubtoc
  145.  
  146. !subsubnode Menü ''Datei''
  147.  
  148. !image img\m_datei.img
  149.  
  150. !begin_description
  151. !item    [''Info'']: Ein Dialog mit Informationen zu UDO wird geöffnet.
  152. !item    [''Hilfe'']: Dem ST-Guide wird gesagt, er solle doch bitte den 
  153.         Hypertext zu UDO öffnen.
  154. !item    [''Beenden'']: Muß ich dazu noch etwas sagen? (!grin)
  155. !end_description
  156.  
  157.  
  158. !subsubnode Menü ''Quelle''
  159.  
  160. !image img\m_quelle.img
  161.  
  162. !begin_description
  163. !item    [''Wählen'']: Im sich öffnenden Fileselektor kann man eine 
  164.         Quelldatei auswählen. Je nach Einstellungen wird die Zieldatei 
  165.         automatisch angepaßt.
  166. !item    [''Editieren'']: Ruft den externen Quelldatei-Editor auf.
  167. !item    [''Anzeigen'']: Ruft den externen Quelldatei-Viewer auf bzw. stellt 
  168.         die Quelldatei im internen Viewer dar.
  169. !item    [''Konvertieren'']: Startet den Umwandlungsvorgang.
  170. !end_description
  171.  
  172. !subsubnode Menü ''Ziel''
  173.  
  174. !image img\m_ziel.img
  175.  
  176. !begin_description
  177. !item    [''Wählen'']: Im sich öffnenden Fileselektor kann man eine 
  178.         Zieldatei auswählen.
  179. !item    [''Editieren'']: Ruft den externen Zieldatei-Editor auf.
  180. !item    [''Anzeigen'']: Ruft den externen Zieldatei-Viewer auf bzw. stellt 
  181.         die Zielldatei -- sofern vorhanden -- im internen Viewer dar.
  182. !item    [''Programm starten'']: Startet das zu einem Zielformat gehörige 
  183.         Pro!-gramm. Siehe dazu auch: Dialog ''Externe Programme''.
  184. !end_description
  185.  
  186.  
  187. !subsubnode Menü ''Optionen''
  188.  
  189. !image img\m_option.img
  190.  
  191. !begin_description
  192. !item    [''Einstellungen]: Öffnet den Dialog ''Einstellungen''.
  193. !item    [''Externe Programme'']: Öffnet den Dialog ''Externe Programme''.
  194. !item    [''Registrieren'']: Öffnet den Dialog ''Registrierung''.
  195. !item    [''Parameter sichern'']: Die aktuellen Einstellungen werden als 
  196.         (!V)UDO.INF(!v) in (falls vorhanden) (!V)$HOME(!v) bzw. im 
  197.         aktuellen Verzeichnis gesichert.
  198. !item    [''Parameter laden'']: (!V)UDO.INF(!v) wird geladen.
  199. !end_description
  200.  
  201.  
  202. ############################################################
  203. # Dialog 'Einstellungen'
  204. ############################################################
  205. !node Dialog ''Einstellungen''
  206.  
  207. !image img\d_sett.img UDO's Einstellungen-Dialog
  208.  
  209. !begin_itemize
  210.  
  211. !item    Ist ''Zieldatei/Anpassen'' selektiert, so wird bei der Auswahl einer neuen 
  212.         Quelldatei oder bei einem Wechsel des Zielformates im Hauptdialog die 
  213.         Zieldatei automatisch angepaßt:
  214.  
  215.     !begin_itemize
  216.     !item    Ist ''Komplett'' ausgewählt, so werden Pfad und Dateiname von der 
  217.             Quelldatei übernommen sowie die zum Zielformat gehörige Endung 
  218.             benutzt.
  219.     !item    Ist ''Name und Endung'' ausgewählt, so wird nur der Dateiname der 
  220.             Quelldatei sowie die zum Zielformat gehörige Endung be!-nutzt. Die 
  221.             Zieldatei kann also auch auf einem anderen Lauf!-werk oder einem 
  222.             anderen Pfad angelegt werden.
  223.     !item    Ist ''Nur Endung'' selektiert, so wird halt nur die Endung der 
  224.             Zieldatei beim Wechsel des Zielformates im Hauptdialog angepaßt
  225.     
  226.     !end_itemize
  227.  
  228. !item    Ist ''Zieldatei/Anzeigen'' selektiert, so wird nach einem 
  229.         Um!-wand!-lungs!-vor!-gang die Zieldatei automatisch angezeigt. Ist 
  230.         zusätzlich ''via externem Viewer'' selektiert, so wird der im 
  231.         Dialog ''Externe Programm'' eingetragene Zieldatei-Viewer 
  232.         ge!-star!-tet. Falls nicht, so wird der interne Minimal-Viewer 
  233.         auf!-ge!-ru!-fen und die Zieldatei dargestellt.
  234.  
  235. !item    Ist ''Logdatei/Anlegen'' selektiert, so legt UDO vor der 
  236.         Um!-wand!-lung eine Datei mit der Endung ''(!V).LOG(!v)'' an, in dem man nach der 
  237.         Um!-wand!-lung Informationen und Fehlermeldungen wiederfindet.
  238.  
  239. !item    Ist ''Nachfrage vor Programmende'' selektiert, so erscheint vor dem 
  240.         Beenden von UDO eine Alertbox.
  241.  
  242. !item    Ist ''Nachfrage vor Überschreiben'' selektiert, so warnt UDO davor, 
  243.         daß eine eventuell bereits existierende Datei beim Um!-wan!-deln der 
  244.         Quelldatei überschrieben würde.
  245. !end_itemize
  246.  
  247.  
  248.  
  249. ############################################################
  250. # Dialog 'Externe Programme'
  251. ############################################################
  252. !node Dialog ''Externe Programme''
  253.  
  254. !stg_subtoc
  255. !pch_subtoc
  256.  
  257. In der GEM-Shell kann man für die Quell- und Zieldatei je einen 
  258. spe!-ziel!-len Editor und Viewer zuordnen sowie für jedes Zielformat ein 
  259. spezielles Programm zuordnen. Diese Programme lasse sich dann im 
  260. Hauptdialog über die Menüzeile starten.
  261.  
  262. !image img\d_xprg.img
  263.  
  264. Im oberen Teil des Dialoges stellt man durch Anklicken der Buttons ein, 
  265. welches externe Programm konfigurieren möchte. Im unteren Teil sieht man 
  266. dann das jeweils zugehörige Programm, die zugehörige Kom!-man!-do!-zeile sowie 
  267. ein paar nötige Einstellungen.
  268.  
  269. Ist ''(!V)Versteht VA_START(!v)'' selektiert, so wird ein Programm nicht erneut 
  270. gestartet, falls es sich bereits im Speicher befindet, sondern dem Programm 
  271. wird die Kommandozeile via (!V)VA_START(!v) übergeben.
  272.  
  273. Falls es sich bei dem jeweiligen Programm um ein TOS-Programm han!-delt, so 
  274. sollte man den entsprechenden Button selektieren.
  275.  
  276. Unter ''Parameter'' kann man einstellen, welche Kommandos an ein zu 
  277. startendes Programm übergeben werden sollen. Da das Eingabefeld re!-la!-tiv 
  278. kurz ist, kann man folgende Platzhalter benutzen:
  279.  
  280. !begin_description
  281. !item    [$I]:    Wird durch den Dateinamen der Quelldatei ersetzt (merke: 
  282.         Infile).
  283. !item    [$O]:    Wird durch den Dateinamen der Zieldatei ersetzt (merke: 
  284.         Outfile).
  285. !item    [$L]:    Wird durch den Dateinamen der Logdatei ersetzt.
  286. !item    [$C]:    Wird durch den Dateinamen der Kommandodatei für den 
  287.         Helpcompiler von Pure-C ersetzt (merke: Commandfile).
  288. !end_description
  289.  
  290.  
  291.  
  292. #-----------------------------------------------------------
  293. # So startet UDO Programme
  294. #-----------------------------------------------------------
  295. !subnode So startet UDO Programme
  296.  
  297. UDO geht beim Starten der Programme folgendermaßen vor:
  298.  
  299. !begin_itemize
  300.  
  301. !item    Wenn Gemini läuft, wird sie via (!V)AV_PROGSTART(!v) damit beauftragt, 
  302. ein Programm zu starten.
  303.  
  304. !item    Falls Gemini nicht läuft und man ein 
  305.         Multi!-tasking-Be!-triebs!-system wie MultiTOS oder Mag!X benutzt, so wird 
  306.         ein Programm parallel mittels (!V)shel_write()(!v) gestartet.
  307.  
  308. !item    Falls Gemini nicht läuft und man mit SingleTOS arbeitet, so 
  309.         werden Programme per (!V)Pexec()(!v) aufgerufen.
  310. !end_itemize
  311.  
  312. Falls UDO als Accessory unter SingleTOS läuft, so ist das Starten von 
  313. Programmen nicht möglich.
  314.  
  315.  
  316.  
  317. #-----------------------------------------------------------
  318. # Konfigurations-Beispiel
  319. #-----------------------------------------------------------
  320.  
  321. !subnode Konfigurations-Beispiel
  322.  
  323. Folgende Einstellungen haben sich bei mir selbst im Laufe der Zeit 
  324. bewährt:
  325.  
  326. !begin_itemize
  327. !item    Quelldatei-Editor: Everest, (!V)VA_START(!v), (!V)$I(!v)
  328. !item    Zieldatei-Editor: Everest, (!V)VA_START(!v), (!V)$O(!v)
  329. !item    Quelldatei-Viewer: 1STVIEW.ACC, (!V)VA_START(!v), (!V)$I(!v)
  330. !item    Zieldatei-Viewer: Everest, versteht (!V)VA_START(!v), (!V)$O $L(!v)
  331. !item    ASCII: ebenfalls 1stView
  332. !item    ST-Guide: HC.TTP, TOS-Programm, (!V)$O(!v)
  333. !item    LaTex: TEXSHELL, (!V)VA_START(!v), (!V)$O(!v)
  334. !item    RTF: Papyrus Gold, (!V)$O(!v)
  335. !item    Pure-C-Help: HC.PRG, TOS-Programm, (!V)$C(!v)
  336. !item    1stWord: ebenfalls 1stView
  337. !end_itemize
  338.  
  339.  
  340.  
  341. ############################################################
  342. # Dialog ''Registrierung''
  343. ############################################################
  344.  
  345. !node Dialog ''Registrierung''
  346.  
  347. Nach Bezahlung der Shareware-Gebühr erhält man von mir einen Schlüs!-sel, mit 
  348. dem man die Einschränkungen der unregistrierten Ver!-sion aufheben kann.
  349.  
  350. !image img\d_regist.img Der Registrierungs-Dialog
  351.  
  352. In diesem Dialog gibt man dann seine persönlichen Daten ein sowie den 
  353. erhaltenen Schlüssel. Klickt man auf ''OK'' und paßt der Schlüssel, so wird 
  354. in ''(!V)$HOME(!v)'' bzw. im aktuellen Verzeichnis eine Datei namens 
  355. (!V)UDO.KEY(!v) gesichert. (!V)UDO.KEY(!v) darf (!U)nicht(!u) weitergegeben 
  356. werden!
  357.  
  358.  
  359. ############################################################
  360. # Feierabend
  361. ############################################################
  362. !end_document
  363.